home *** CD-ROM | disk | FTP | other *** search
- OVERVIEW:
-
- WIDENTIFY is a companion program to WICONIFY and WICONSETTER. It helps you
- to identify the program, screen and window names of existing windows, and of
- new windows and screens as they are openned.
-
- wIconSetter identifies a window by using the name of the program that opens
- the window, the name of the screen where it is openned, and the name of the
- window itself. Usually, it is easy to tell the name of the window and
- screen, but more difficult to determine what program opens a window.
- wIdentify is intended to make this easy.
-
-
- USING WIDENTIFY:
-
- To find out the PROGRAM, SCREEN and WINDOW titles for the active window,
- simply issue the command:
-
- 1> wIdentify
-
- wIdentify will look up the active window and print the results.
-
- To specify a window other than the active one, type:
-
- 1> wIdentify WINDOW <name>
-
- where <name> is replaced by the name of the window about which you want
- information. If the name includes spaces, be sure to enclose the name in
- quotation marks. You need only give as much of the name as needed to
- distinguish it from the other windows. Upper and lower case letters are
- treated as the same, so capitalization doesn't matter.
-
- If the window is not on the active screen, you will need to tell wIdentify
- what screen to look on, as in the following:
-
- 1> wIdentify WINDOW <window_name> SCREEN <screen_name>
-
- The same rules apply for screen names as for window names.
-
- If you give a screen name only, without a window name, then wIdentify will
- print the information for ALL the windows on the specified screen. For
- example, the following command identifies all windows on the Workbench screen:
-
- 1> wIdentify SCREEN "Workbench"
-
- You can get information about every window on every screen by giving the
- following command:
-
- 1> wIdentify ALL
-
-
- Although the screen and window names are always available from the data
- associated with a window, it is not always possible to determine the program
- that owns a window from an existing window. When this is the case,
- wIdentify will list the program name as "[Unknown]". This is true, for
- example, for all CON: and RAW: windows. These are created by programs named
- 'CON' (or 'NEWCON') and 'RAW', but their names can not be determined from
- the windows after they are openned.
-
- wIconSetter traps the OpenWindow() Intuition library routine, and when this
- is called, wIconSetter finds the program name from the Process or Task data
- structure of the program that called OpenWindow(). This always gets the
- program name, even for CON: and RAW: windows.
-
- If wIdentify reports a window's program as "[Unknown]", you will need to use
- wIdentify in a different fashion:
-
- 1> RUN wIdentify NEW
-
- This will start wIdentify as a seperate process (but its output will still
- go to the CLI window where you ran it). When you specify the option NEW,
- wIconify will trap the OpenWindow(), OpenScreen() and SetWindowTitles() calls,
- just like wIconSetter does, and will report the identities of all windows and
- screen as they are openned, and windows whose titles change.
-
- This is the most accurate information about windows and screens, but it gives
- information only as they open or their titles change, not about ones that are
- already open. Since this is what wIconSetter uses, however, this is the best
- source of a window's or screen's "true" identity.
-
- To end the wIdentify process, use the BREAK command to send a CTRL-C to the
- wIdentify process. For example, if the RUN command says that CLI 3 was
- created, then use the command
-
- 1> BREAK 3 C
-
- to stop wIdentify.
-
- Note: some programs, for example the calculator distributed on the WB 1.3
- disk, open their windows with no title, and then add the title afterwards.
- wIdentify NEW will report these windows twice: once when they open (with
- NULL titles), and then again as the titles change.
-
- If you have trouble adding an icon to a window and you think you have
- specified it correctly, use WIDENTIFY NEW to check that the name is really
- what you expect.
-
-
- AUTHOR:
-
- Davide P. Cervone
- Mathematics Department
- Brown University
- Providence, Rhode Island 02912
- ST402523@BROWNVM
-